Release notes

May 2026

Product search extended

Business impact

The product search functionality in the Content API has been extended.

What changed

  • Added new filters to the GET /products search endpoint

  • Enriched several fields in the product search response

  • Removed the version and fuzziness query parameters

  • Breaking change: Yes

New filters

The following query parameters were added to GET /products:

  • productCode: Filter based on product code

  • genre: Filter based on genre

  • createdOnStartDate: Filter based on creation date, start of range

  • createdOnEndDate: Filter based on creation date, end of range

  • copyrightSheetFilter: Filter based on whether copyright sheets are linked

  • copyrightSheetStatus: Filter based on copyright sheet status

  • copyrightSheetVersion: Filter based on copyright sheet version

  • seasonYear: Filter based on season year

  • productionFormRequestFilter: Filter based on production form request availability

Affected endpoints

Product search

  • GET /products

Example

Example request:

GET /products?productCode=OB00009376/__/0001&copyrightSheetFilter=true&seasonYear=2025

Updated response information

The product search response now contains additional information:

  • boGenres: Genres linked to the product

  • copyrightSheets: Copyright sheets linked to the product

  • hasActiveProductionForms: Indicates whether active production forms exist

  • subtitled: Indicate: whether the product is subtitled

  • timeSlotCategory: Time slot category of the product

Several existing fields now return richer objects instead of only identifiers, including:

  • source type

  • status

  • original language

  • category

  • department

  • product display type

  • content collection intentions

  • tags

  • production companies

  • contact person

  • season

  • series

Breaking changes

Yes. This change may be breaking because:

  • The version query parameter was removed

  • The fuzziness query parameter was removed

  • Several response fields changed from simple UUID strings to objects

  • boGenres and hasActiveProductionForms were added as required fields in the ProductSearchLightJson response schema

API details
Added query parameters on GET /products
  • productCode
  • genre
  • createdOnStartDate
  • createdOnEndDate
  • copyrightSheetFilter
  • copyrightSheetStatus
  • copyrightSheetVersion
  • seasonYear
  • productionFormRequestFilter
Removed query parameters on GET /products
  • version
  • fuzziness
Updated response schema: ProductSearchLightJson

Added properties:

  • boGenres
  • copyrightSheets
  • hasActiveProductionForms
  • subtitled
  • timeSlotCategory

Updated properties:

All changed from referencing UUID string to DropDownJson

  • sourceType
  • status
  • originalLanguage
  • categoryDropdown
  • department
  • productDisplayType
  • contentCollectionIntentions
  • tags
  • productionCompanies
  • contactPerson
  • season
  • series
YAML changes
Paths

Updated:

  • /products

No new paths were added.

Schemas

New:

  • ReferenceJson

Updated:

  • ProductSearchLightJson

  • SearchContentPublicationDetailJson

Comparison

YAMLs can be compared in more detail using: TextCompare

See the changes in the Explorer.

October 2024

Addition of Content API for publication sheets

From this version on, it is possible to manage publication sheets using part of the content API. It allows to

  • create, retrieve, delete and update publication sheets;

  • search for and get details of content.

For more information, see the OpenAPI definition.